home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / System7 tools / D / Drop Text 1.3 / Drop Text - Read Me next >
Encoding:
Text File  |  1993-11-17  |  5.6 KB  |  155 lines  |  [TEXT/ttxt]
  1.  
  2. About Drop Text 1.3
  3. -------------------
  4.  
  5. (This document looks best with Monaco-9)
  6.  
  7. Drop Text is a drag-and-drop program that I wrote to convert a
  8. multitude of text files that we seem to collect into whatever
  9. format is needed. In this case, conversion between Mac (or Apple
  10. II), MS-DOS, and Unix are what is done.
  11.  
  12. There are other programs out there that can do these, of course,
  13. but mine has some advantages:
  14.  
  15. • Converts the file "in-place" - you don't have to bother with
  16.   extensions to the filename to get rid of or tons of duplicate
  17.   files.
  18. • Very safe - any error aborts the process, leaving the file being
  19.   converted untouched.
  20. • Abortable at any point.
  21. • Checks the file for resource forks and "illegal" ASCII codes and
  22.   does warnings - you can then choose to stop, skip, continue, or
  23.   just do them all.
  24. • Processes directories up to 10 levels deep.
  25. • Can work on non-text files if you so desire.
  26. • Can change the file type & creator if you want.
  27. • Can remove trailing tabs and spaces from lines if you want (great
  28.   for C/C++ source files!).
  29. • Can remove high bits of text (high ASCII into low ASCII).
  30. • Can convert AppleWorks WordProcesser files to text files.
  31. • Fast - processes in excess of 15k per second on a stock IIsi.
  32.  
  33.  
  34. How to use this:
  35.  
  36. Well, real simple: select some files and drag it on top of the icon
  37. (the falling safe). If you hold down the OPTION button as you drop
  38. the file(s) or folder(s), the program will give you the Conversion
  39. Settings (the Options :) ) dialog. These settings are saved in the
  40. Preferences directory, so the next time you use the program it will
  41. use the same settings as before.
  42.  
  43.  
  44. Requirements for use:
  45.  
  46. • System 7.0 or later.
  47. • 42k on disk for program, 384k when running.
  48. • Some text or AWP files to convert (of course).
  49.  
  50.  
  51. Compatability:
  52.  
  53. • 32-bit clean.
  54. • Should work on a 68000 cpu - if not, let me know.
  55. • If this doesn't work on your IIvx, I'm sorry, but it works on
  56.   everything else I've tried (SE, SE/30, IIsi, PowerBooks, etc).
  57.  
  58.  
  59. Known issues:
  60.  
  61. • This program will -not- convert a file unless that files is on the same
  62.   volume as Drop Text -- this is a problem that will be fixed later on,
  63.   but for right now, is not too terrible for me to live with.
  64. • If you don't tell me about things to do to this, I cannot (and will not)
  65.   do anything! Two letters in six months is pretty sad.
  66.  
  67.  
  68. Legal stuff:
  69.  
  70. Drop Text 1.3 is totally free. Not for sale or profit for any
  71. reason. This program can only be GIVEN AWAY - it cannot be sold or
  72. charged for in any way shape or form (in other words, if you put it
  73. on a CD-ROM or on a pay-for-use system, don't charge the user for
  74. getting this program).
  75.  
  76. The standard legal disclaimer applies: Not responsible, not my
  77. fault, your problem, not mine. It hasn't broken my machine in the
  78. time I've used it. Bla Bla Bla. If you loose your one and only text
  79. file version of War and Peace because this program ate it, you
  80. should have backed it up first.
  81.  
  82. This junk aside, seriously, the program hasn't messed me up yet -
  83. which is why I put all the safty-checks in there in the FIRST
  84. place. In you accidently converted the file to DOS from MAC, just
  85. convert it back.
  86.  
  87.  
  88. Other stuff:
  89.  
  90. • If you get a Bus Error when you launch this thing, don't blame me -
  91.   blame Apple. It happens to me when I run Teach Text sometimes
  92.   too. Just hit the button (if you're in 32 bit mode) to exit and try
  93.   it again. Otherwise, reboot. I've done my best to track it down and
  94.   fix it (somewhere in SetPort).
  95. • Source -IS- available if you want it.
  96.  
  97.  
  98. Version History:
  99.  
  100. 1.0:
  101.     First public release.
  102. 1.1:
  103.     Modifed program to strip bit 7 from text files. Will warn you if
  104.         it finds one before it does this.
  105.     Cleaned up dialog display so that it's not flashing.
  106.     Expanded the memory from 100k to 384k so that more than 40
  107.         files can be processed at once.
  108.     Doubled the size of the file buffer so that it doesn't hit the
  109.         disk as much.
  110.     Moved where the temp file was at (now on the boot volume's
  111.         hidden Temporary Files folder). This keeps the Finder from
  112.         updating info behind my back and slowing the program down.
  113.     Fixed (hopefully) problem with program blowing with a bus error
  114.         (tracked it down to SetPort - anyone got any ideas?)
  115.     Added beep to the "What Now?" dialogs.
  116.     Added beep when process takes longer than a minute.
  117.     Added support for b&w users - title box and progress bar.
  118. 1.2:
  119.     Program can now optionally change the file type and/or creator.
  120.     Program can now optionally strip trailing spaces and tabs from
  121.         lines. NOTE: This can miss a space or three if the line
  122.         break occurs at juuust the right spot.
  123. 1.3:
  124.     Program can now optionally convert AppleWorks AWP files to
  125.         text files. I did this because I found a bunch of 800k
  126.         ProDOS disk with AWP files on it that I wanted to convert
  127.         over (and since company's copy of AW3.0 died along with the
  128.         //e, there was no way to get the data out!).
  129.     The program now gets Finder to update file information a little
  130.         faster.
  131.     The program can now optionally strip the hi bits - was previously
  132.         always stripping them.
  133.     The dialogs were changed so that they are positioned correctly on all
  134.         screens now (was previously shooting off to the right on some
  135.         systems). I also changed the dialog types from what I thought was
  136.         pleasing to what "some people" belive is correct. If you like the
  137.         old ones, use ResEdit to change them back.
  138.     The Progress dialog can now be dragged around the screen; the position
  139.         is saved as part of your preferences.
  140.     Aborts a little faster.
  141.  
  142.  
  143. Address for letters, disks, free food:
  144.  
  145. Todd C. Wilson
  146. Omnitech Electronics, Inc.
  147. 5090 Trabue Road
  148. Columbus, Ohio  43228
  149.  
  150. Email:
  151.  
  152. If you want, send email to the uploader of this software --
  153. they should be able to forward the text to me.
  154.  
  155.